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1 . Introduction 


The  Packet  Speech  Measurement  Facility  (PSMF)  is  a 
recording,  playback,  and  measurement  facility  designed  to 
provide  members  of  the  Network  Secure  Communications  (NSC) 
Project  with  an  investigative  tool  for  packetized  speech 
research.  PSMF  access  will  facilitate  experiments  dealing 
with  the  effects  of  network  induced  perturbations  on 
real-time  communications. 

This  report  describes  efforts  undertaken  by  the  Computer 
Corporation  of  America  during  the  initial  phase  of  PSMF 
development:  December  11  , 1976  to  June  30,  1977.  These 

efforts  have  culminated  in  the  specification  of  PSMF 
design,  the  development  of  an  access  protocol,  and  the 
release  of  a trial  facility  with  operational  recording  and 
playback  functions. 

Chapter  2 reviews  the  PSMF  design  philosophy  and  structure 
detailed  in  the  Preliminary  Design  Document  of  February 
28,  1977.  Chapter  3 elucidates  the  approaches  CCA  has 

taken  to  implanent  this  structure.  Chapter  discusses 
the  work  scheduled  for  completion  of  this  initial  phase  of 
the  PSMF,  while  chapter  5 provides  a summary  of  PSMF 


efforts  and  plans. 
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2.  PSMF  Design  Philosophy  and  Structure 


The  intent  of  the  PSMF  is  to  provide  a facility  whereby 
NSC  participants  can  rigorously  examine  network  effects  on 
real  time  encoded  packet  speech  streams.  Three  primary 
functions  have  been  designed  to  satisfy  this  intent: 

1.  The  provision  for  recording  speech  segments  along 
with  time  stamps  reflecting  network  perturbations. 

2.  The  provision  for  playback  of  speech  segments  to 
enable  subjective  judgements  of  network 
di stortions . 

3.  The  provision  of  statistical  functions  which 
analyze  recorded  speech  segments  to  determine  the 
charactertistics  of  network  distortion. 

In  section  2.1  we  elaborate  on  the  specifications  for 
these  functions.  Section  2.2  outlines  the  extension  to 
the  Network  Voice  Protocol  by  which  a user  can  request 
these  functions,  and  section  2.3  deals  with  the  PSMF 
structure  designed  to  accomodate  these  specifications 
under  the  protocol  extension. 
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2.1  PSMF  Function  Specifications 


2.1.1  Recording 

The  PSMF  Recording  function  is  designed  to  provide  a means 
for  storage  of: 

a.  Speech  segments  consisting  of  streams  of  encoded 
voice  messages. 

b.  Special  non-voice  control  messages,  which  may  be 
imbedded  within  a voice  stream. 

c.  Information  pertinent  to  subsequent  analysis,  such 
as  a time  stamp  on  receipt  of  each  message. 

Each  recorded  segment  is  identified  by  name  ("filename") 
and  secured  with  an  access  password.  The  typical 
recording  session  proceeds  as  follows: 
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1.  The  user  initiates  a connection  with  the  PSMF  over 
the  Arpanet. 


2.  The  user  requests  the  Recording  function  specifying 
filename  and  an  optional  password. 


3.  The  PSMF  acknowledges. 


4.  The  user  can  send  any  number  of  special  PSMF 
non-voice  messages  for  recording. 


5.  If  the  user  wants  to  record  voice. 


a.  He  asks  to  be  negotiation  master, 


b.  The  PSMF  accedes. 


c.  The  user  suggests  negotiation  parameters. 


d.  The  PSMF  agrees  to  all  suggestions  and 
records  the  negotiations. 


e.  The  user  asks  if  the  PSMF  is  ready. 
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f.  If  information  sufficient  for  playback 
timing  has  been  negotiated,  the  PSMF  signals 
its  readiness. 

g.  The  user  sends  a stream  of  voice  messages 
and  special  PSMF  non-voice  control  messages 
to  be  recorded. 


6.  The  user  signals  the  end  of  the  recording  session. 


2.1.2  Playback 


The  PSMF  provides  an  access  to  previously  recorded 
segments  that  enables  selective  playback  of  voice  and/or 
non-voice  messages.  Voice  stream  playback  permits 
repeatable  tests  of  vocoding  equipment  and  algorithms. 
Imbedded  control  messages  can  be  used  to  carry  textual, 
graphical,  or  machine  control  information.  In  addition, 
the  results  of  a PSMF  measurement  function  may  be 
incorporated  into  files  of  PSMF  control  messages,  which 
are  then  subject  to  playback.  The  suggested  procedure  for 
playback  is  as  follows: 


Packet  Speech  Measurement  Facility  Paf^e  6 

PSMF  Design  Philosophy  and  Structure  Section  2 

1.  The  user  initiates  a connection  witn  the  PSMF  over 
the  Arpanet, 

2.  The  user  requests  the  Playback  function,  specifying 
filename  and  password. 


3. 

The  PSMF  acknowledges 

success 

if  the 

filename 

exists  and  password  is 

correct . 

4. 

The  user  specifies  the 

types  of 

messages 

to  be 

played  back,  (e.g. 

voice  and 

textual 

control 

messages) . 

5.  If  the  user  has  specified  voice  playback, 

a.  The  PSMF  asks  to  be  negotiation  master. 

b.  The  user  accedes. 

c.  The  PSMF  presents  the  same  negotiation 
parameters  encountered  in  recording. 

d.  The  user  agrees  to  all  suggested 
negotiati ons . 
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e.  The  PSMF  asks  if  tne  user  is  ready. 

f.  The  user  assents. 

6.  The  PSMF  plays  back  the  requested  information. 
Voice  data  is  timed  according  to  negotiation 
parameters  and  message  headers.  Control  data  is 
sent  so  that  only  one  control  message  is  in  transit 
at  a time. 

7.  The  PSMF  completes  playback,  or  the  user  signals  an 
end  to  the  playback  session. 
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2.1.3  Measurement  Functions 


The  PSMF  measurement  functions  provide  means  for  analyzing 
parameters  in  PSMF  files  and  creating  PSMF  files,  suitable 
for  playback,  containing  the  results  of  such  analyses. 
Measurement  functions  are  concerned  with: 

a.  Relative  delays  inflicted  on  voice  packets  by  the 
network . 

b.  Missing,  duplicate,  or  out  of  order  voice  packets. 

c.  Qualities  of  the  voice  stream  itself,  e.g.  periods 
of  silence  and  speech. 

Measurements  consist  of  statist - cal  analyses  (mean  and 
standard  deviation)  and  histogram  constructions.  The 
standard  procedure  for  invoking  a measurement  function  is 
as  follows: 

1.  The  user  initiates  a connection  with  the  PSMF  over 


the  Arpanet. 
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2.  The  user  requests  the  Measurement  function, 
specifying  filename  and  password  of  the  file  to  be 
me  asur ed . 

3.  The  PSMF  acknowledges. 

The  user  specifies  the  nature  of  the  measurement 
and  the  filename  and  password  of  the  file  which 
receives  the  analyses. 

5.  The  PSMF  acknowledges  and  disconnects  to  allow 
other  concurrent  PSMF  access. 

6.  At  a later  time  the  user  can  play  back  the 
measurement  file  or  subject  it  to  further  analysis. 


i 
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I 2.1.4  File  Manipulation 

I ; Two  provisions  for  PSMF  file  "manipulation"  are  included 

i 

1 in  the  current  design:  file  appendage  and  file  deletion. 

: These  functions  are  available  only  to  the  site  which 

1 created  the  file. 

r 

i The  PSMF  Append  function  permits  a user  to  add  voice 

and/or  non-voice  control  messages  to  an  extant  file  of  his 
own  creation.  The  procedure  for  appending  is  as  follows: 

1.  The  user  initiates  a connection  with  the  PSMF  over 
the  Arpanet. 

2.  The  user  requests  the  Append  function,  specifying 
filename  and  password. 

3.  The  PSMF  acknowledges. 

4.  The  user  can  proceed  as  in  recording,  except: 

I If  the  user  trys  to  negotiate  voice,  and  the 

i 

• , extant  file  contains  voice  data, 

! 

i 

» 

i 


I 
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r 


a.  The  PSMF  asks  to  be  negotiation  master. 

b.  The  user  accedes. 

c.  The  PSMF  presents  the  same  negotiation 
parameters  encountered  in  the  recording 
of  the  original  file. 

d.  The  user  agrees  to  all  suggested 
negotiations . 

e.  The  PSMF  asks  the  user  to  be  negotiation 
master . 

f.  The  user  agrees. 

g.  The  user  asks  if  the  PSMF  is  ready. 

h.  The  PSMF  agrees. 


i.  The  user  sends  a stream  of  voice  and/or 


1 


I 

a 

* 

I 

I 

I 

I 


i 

i 


-.t'. 
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5.  The  user  signals  the  end  of  the  append  session. 

Application  of  the  Delete  function  causes  the  named  file 
I to  be  expunged.  It  is  invoked  as  follows  : 

1.  The  user  initiates  a connection  with  the  PSMF  over 

f. 

[ the  Arpanet. 

[ 

i: 

I 

[ 2.  The  user  requests  the  Delete  function,  specifying 

filename  and  password. 

3.  The  PSMF  acknowledges. 
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2.2  PSMF  Protocol  Extension  (1) 


PSMF  Protocol 


This  protocol  is  an  extension  to  the  Network  Voice 
Protocol  to  allow  access  to  a Packet  Speech  Measurement 
Facility.  It  provides  a means  to  specify  recording  and 
playback  of  speech  files,  and  then  to  select 
measurements  and  statistical  analyses  of  those  files. 

This  protocol  is  based  on  the  NVP:  it  uses  the  same 
initial  connection  proceedures  (ICP),  assignment  of 
links,  vocoder  negotiation,  and  ARPAnet  message 
types/subtypes  (type-0/0  for  control  messages  and 
type-0/3  suggested  for  data).  The  format  of  data 
messages  is  the  same  as  for  normal  NVP.  The  reader  is 
referred  to  the  NVP  document  for  details. 


1.  This  section  was  prepared  in  conjunction  with  ISI. 
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The  ICP  for  NVP  is  the  following  sequence  of  three 
messages: 


On  link  377:  1 , <WHO> , <WHOM> , K 

On  link  K:  6,L 

On  link  L:  1 , <WHO> , <WHOM> , K 


For  normal  NVP,  the  ANSWERER  replies  to  the  second 
[1]  message  by  initiating  vocoder  negotiation. 
Instead,  when  a PSMF  is  called,  it  replies  with  an  "OK, 
I AM  A PSMF"  message.  After  that,  the  caller  can 
request  different  operations  using  this  PSMF  Protocol. 


^ Summary  of  Messages 


The  PSMF  Protocol  messages  are  listed  below,  then 
described  later.  All  PSMF  requests  are  made  with  the 
same  message  code,  with  each  different  request  having  a 
unique  subcode.  Acknowledgement  is  via  a different 
message  code  with  the  subcode  returned  from  the 
request.  The  list  of  message  codes  and  subcodes  is  as 
follows : 

[60] 


[61], [1] 


"OK,  I AM  A PSMF" 

"OPEN  A FILE  TO  RECORD" 


I 


i 

I 

1 

I 
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[61], [2] 
[61], [3] 
[61], [4] 
[61], [5] 

[6 1] , [6] 
[61], [7] 
[61], [8] 

[61] , [9] 
[61], [10] 

[62] ,  [n] 

[63] , [n] 


"OPEN  A FILE  FOR  PLAYBACK" 

"OPEN  A FILE  TO  APPEND" 

"RETRIEVE  FIELDS" 

"FIELD  TO  BE 

RECORDED'V'RETRIEVED  FIELD" 

"CLOSE  FILE'V'END  OF  FILE" 

"DELETE  FILE" 

"TEXT  TO/FROM  COMMAND  PARSER" 

"DATA  TO/FROM  MEASUREMENT  FACILITY" 
"OPEN  A FILE  FOR  MEASUREMENT" 
"POSITIVE  ACKNOWLEDGEMENT" 

"NEGATIVE  ACKNOWLEDGEMENT" 


Description  of  Messages 


In  addition  to  message  codes  and  subcodes,  PSMF 
messages  contain  elements  labelled  <field-name>  and 
<string>.  A <field-name>  is  a single  16-bit  word  which  is 
the  identifier  for  a field  as  specified  by  the  PSMF  file 
format.  Possible  values  for  <field-name>  are  listed  later 
in  this  document.  A <string>  is  a sequence  of  N+1  16-bit 
words,  where  the  first  word  is  the  count  of  words  to 
follow,  i.e.  N.  Each  word  contains  two  8-bit  ASCII 
bytes,  with  the  byte  in  the  most  significant  8 bits  of 


j 
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the  word  preceding  the  byte  in  the  least  significant  8 
bits  of  the  word.  The  string  also  includes  either  1 or  2 
NUL  (binary  zero)  terminating  bytes,  depending  on 
whether  there  are  an  odd  or  even  number  of  text  bytes 
contained  in  the  string,  respectively.  That  is, 

<string>  = N,W(1),W(2) W(N) 

For  example, 

"FILENAME"  = 5,  FI,  LE,  NA,  ME,  00 

The  other  fields  in  the  messages  below  are  16-bit  words, 
with  the  values  right- justif ied  in  the  word.  Any  extra 
words  in  the  message  after  those  which  are  defined  should 
simply  be  ignored  by  the  receiver  of  the  message. 

[60]  "OK,  I AM  A PSMF" 

This  message  is  used  only  to  answer  the  second  1 message 
during  ICP.  It  consists  of  only  one  word: 

60 

[61] ,[1]  "OPEN  A FILE  TO  RECORD" 

Only  one  file  may  be  opened  at  a time,  but  different  files 
may  be  opened  in  succession  (see  the  "EOF"  message). 
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This  message  varies  in  length;  it  contains  two  words 
followed  by  two  strings: 

6 1 , 1 , < f ilename-s tring> ,<password-string> 

The  PSMF  will  create  a file  with  the  given  name  (unless 
the  name  is  not  suitable),  and  record  the  password  to 
compare  against  the  password  given  when  the  file  is 

opened  for  playback.  This  operation  will  be 

acknowledged,  either  positively  or  negatively,  by  a 
[62]  or  [63]  message,  respectively  (see  below). 


[61], [2]  "OPEN  A FILE  FOR  PLAYBACK" 

This  message  has  the  same  format  as  "OPEN  FOR  RECORD": 
61,2, <f i lename-s tring> , <password-s tr ing> 


The  PSMF 

will 

search  its 

directory  for 

the  given 

filename . 

I f it 

is 

found , 

the  password 

will 

be 

checked 

aga inst 

the 

one  recorded  with  the 

file 

to 

determi ne 

if  access 

is 

a 1 lowe  d . 

Again  a [62]  or 

[63] 

i s 

sent  as  acknowledgement. 


[61], [3]  "OPEN  A FILE  TO  APPEND" 
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This  message  allows  the  caller  to  append  more  information 
or  speech  to  the  end  of  an  extant  file.  Again,  the 
password  must  match  the  one  recorded  when  the  file  was 
created.  The  format  is: 

6 1 , 3 , < f ilename-s tring> ,<password-string> 


[61], [4]  "RETRIEVE  FIELDS" 

When  a file  is  open  for  playback,  this  message  requests 
that  all  fields  with  given  field  names  be 

extracted  from  the  file  and  sent  to  the  caller.  The 
message  consists  of  the  words: 

6 1 , 4 , n , <f ield-name  1 >,..., <f ield-name  n> 

This  message  is  positively  acknowledged  by  the  receipt  of 
the  requested  fields,  or  negatively  acknowledged 

explicitly  by  a [631, [4]  message.  After  all  fields  have 
been  sent,  the  PSMF  sends  an  "EOF"  message  (this 

includes  the  case  where  no  fields  exist). 

[61],  [5]  "FIELD  TO  BE  RECORDED'VRETRIEVED  FIELD" 

This  message  is  of  variable  length,  and  may  contain  a 
string  or  any  collection  of  words: 
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61 ,5,<field-name> ,N , W( 1 ) , W( 2) , . . . , W( N ) 


Voice  files  may  contain  text  or  binary  fields.  Messages 
of  this  type  which  are  received  by  the  PSMF  while  a 


file 

is  open  for  record  will  be  inserted 

into 

the 

file. 

Note 

that  voice  data  messages 

are 

not 

sent 

using 

this 

message,  but  are  sent  on 

the 

NVP 

data 

link 

instead.  This  message  is  also  used 

to 

return 

non- 

voice 

fields  in  response  to  a [61], [4]  request. 


[6  1],  [6]  "CLOSE  FILE'V'END  OF  FILE" 

This  message  is  sent  by  the  caller  to  indicate  the  end  of 
data  to  be  recorded  or  to  indicate  that  no  more 
information  is  desired  from  a file  during  playback.  For 
this  usage,  the  message  has  the  consists  of  only  two 
words  : 


61,6 

This  message  is  also  sent  by  the  PSMF  to  indicate  that  no 
more  fields  of  the  requested  type  are  left  to  play 
back.  It  does  not  mean  that  the  PSMF  has  closed  the  file. 
This  message  contains  the  message  code  and  subcode 
followed  by  the  number  of  messages  transmitted: 
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61,6  ,<message-count> 

The  <message-count>  is  a 32-bit  integer. 


[61],[7]  "DELETE  FILE" 

This  message  is  sent  by  the  caller  to  the  PSMF.  Its 
format  is 


6l ,7,<filename-string> , <password-string> 

This  message  looks  up  the  given  filename,  and  deletes  the 
file  if  the  password  matches  the  one  recorded  with  the 
file. 


[61], [8]  "TEXT  TO/FROM  COMMAND  PARSER" 

This  message  provides  a means  to  send  text  messages 
to/from  the  measur  ement  facility.  Its  format  is: 

6 1 ,8 , < string> 

These  messages  might  be  commands  to  the  PSMF  or  replies 
from  it.  In  addition,  results  of  measurements 
might  be  reported  using  this  technique.  Typically, 
these  messages  would  simply  be  tyoed  out  on 
terminal  (if  any). 


the  user's 
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[61], [9]  "DATA  TO/FROM  MEASUREMENT  FACILITY" 

This  message  has  basically  the  same  format  as  the  [61], [8] 
message,  but  the  data  is  not  necessarily  a string  of 
ASCII  bytes: 

61.9, N,W( 1),W(2), ...,W(N) 

The  meaning  of  these  data  words  is  not  defined  by  this 
document.  This  message  is  orovided  to  allow 
measurement  commands  or  data  to  be  passed  between  the  PSMF 
and  its  caller;  the  sub-protocol  which  defint  the 
meaning  of  the  data  words  has  not  yet  been  specified. 

[61], [10]  "OPEN  A FILE  FOR  MEASUREMENT" 

This  message  has  the  same  format  as  "OPEN  FOR  PLAYBACK": 

61 . 10, <filename-string>, <password-string> 

The  procedure  and  response  is  the  same  as  for  "OPEN  FOR 
PLAYBACK"  . 


[62], [n]  "POSITIVE  ACKNOWLEDGEMENT" 
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This  message  echoes  the  message  which  it  acknowledges, 
except  that  the  [6l]  is  replaced  by  [62],  for  examole: 

61,1  ,"FILE"  .‘'PASSWORD" 

62,1 , "FILE" ."PASSWORD" 


Currently,  it  is  used 

only 

in  this 

fashion 

to 

acknowledge  opening  of 

f il es . 

If  in 

the  f uture 

i t 

is  used  to  acknowledge  a message  with  a different  format, 
the  format  of  the  [62]  message  would  again  follow  the 
format  of  the  message  it  acknowl  edges . 


[63], [n]  "NEGATIVE  ACKNOWLEDGEMENT" 

Like  the  [62]  message,  this  message  echoes  the  message  it 
acknowledges.  However,  in  addition  to  reolacing  the 
[6  1]  with  [63],  this  message  appends  a reason  code  and 
string  to  the  end  of  the  acknowledged  message: 

61 . 1 . "FILE" ."PASSWORD" 

63. 1 ,  "FILE" , "PA  SSWORD" , < r eason-cod  e> , < r eason- str ing> 


If  the  sender  desires  not  to  include  a 
<r eason-string> , he  should  indicate  a null  strinc  by 
giving  a zero  word  count  for  the  string.  Therefore,  the 
minimal  appendage  would  be  two  words  of  zero,  the  first 
indicating  an  unspecified  reason, 


and  the 


second 
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indicating  a null  string.  Note  that  this  message  is  also 
used  with  the  [6l],[4]  and  [6l],[5]  messages,,  which  have 
a different  format: 

61 , 4 ,<f  ield-name> 

6 3 , 4 , <f  i eld-nam  e>  , < r eason-cod  e>  , < r eason- s tr ing> 
Reason  codes  are  defined  later  in  this  document. 


Vocoder  Negotiation 


In  order  to  send  voice  data  to/from  the  measurement 
facility,  the  two  parties  must  negotiate  vocoder 

parameters.  However,  a caller  who  is  incapable  of 
handling  voice  data  may  want  to  access  textual  data  in 
a voice  fixe,  so  vocoder  negotiation  is  optional  within 
a PSMF  protocol  session. 

Vocoder  negotiation  is  initiated  with  an  NVP 
"RENEGOTIATION  REQUEST"  message,  number  [12].  This 

message  consists  of  two  words, 

1 2 , <I-ma  ster> 

During  recording  of  a voice  file,  the  caller  sets 

<I-master>  to  a nonzero  value  to  indicate  that  he 

desires  to  negotiate  the  vocoder  parameters  to  be  stored 


• 
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Acceptance  by  the  caller  will  cause  the  PSMF  to  conduct 
negotiations  as  per  the  stored  vocoder  parameters.  For 
more  detail,  see  the  sections  on  negotiation  and 
renegotiation  in  the  NVP  document. 


Obviously,  vocoder  negotiation  must  occur  before  transfer 
of  voice  data  messages  is  possible.  On  recording,  if 
the  caller  sends  voice  data  before  negotiating,  the  PSMF 
should  simply  ignore  the  data. 


PSMF  File  Format  Field  Names 


A field  name  is  recorded  as  the  first  word  of  every 
record  in  a PSMF  secondary  file  to  specify  the  field  tyoe. 
The  least  significant  8 bits  of  the  field  name  are  the 
field  type,  and  the  most  significant  8 bits  indicate 
the  use  of  that  field,  depending  uoon  the  field  tyoe. 
The  following  field  names  have  been  defined: 

Field  Type  Use  if  Voice  Use  if  Text 
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0 voice 

1 control 

2 t ext 

3 binary 

4 graphics 


(not  defined)  1 author 

2 sender 

3 to 

4 c c 

5 subject 

6 date 

7 summary 


Reason  Codes 


The  following  reason  codes  have  been  defined: 

0.  Unspecified  reason 

1 . No  access  right 

2.  File  does  not  exist 

3.  Wrong  oassword 

4.  Vocoder  negotiation  needed  first 

5.  No  file  has  been  opened 

This  list  is  incomplete  and  will  be  augmented  as  the  need 
arises. 


Packet  Speech  Measurement  Facility 
PSMF  Design  Philosophy  and  Structure 


Page  26 
Section  2 


2.3  PSMF  Structure  Design 


The  Digital  Equipment  Corporation  RSX-11M  ooerating  system 
was  chosen  as  the  vehicle  for  development  and 
implementation  of  the  PSMF.  Reasons  for  this  were: 

a.  A development  machine  under  RSX-11M  was  available. 

b.  RSX-11M  has  adequate  software  development  tools. 

c.  A well  developed  file  system  is  offered. 

d.  RSX-11M  provides  executive  services  for  scheduling, 
inter-process  communications,  timing,  I/O,  and 
dynamic  memory  allocation  and  mapping. 

With  these  facilities  available,  it  was  decided  to  design 
the  PSMF  as  a set  of  functionally  disjoint  processes. 
These  processes  would  communicate  via  executive  directives 
and  a common  buffer  area,  and  would  share  the  services  of 
a set  of  library  routines. 

The  PSMF  user  is,  of  course,  unaware  of  these  components. 
His  view  of  the  system  might  be  as  illustrated  in  figure 

2.1. 


■•t.V  -T 
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Figur  e 2 . 1 


Figure  2.1 
User's  View  of  PSMF 


PSMF 

FILES 


$ 


USER  HOST 


NVP 


RPANET 


PSMF  HOST 


NVP 


A more  detailed  examination  of  the  structure  to  be  found 
at  the  PSMF  host  is  diagrammed  below  in  figure  2.2. 
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Figur  e 2 . 2 
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Figure  2.2 

Process  Structure  at  PSMF  Host 
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The  following  sections  discuss  the  design  objectives  of 
the  PSMF  elements  ixxustrated  in  figure  2.2. 

2.3.1  RSX-11M  Executive  and  Network  Driver 


The  executive  provides  a wide  variety 
communications  services.  Explicit 
executive  services  are  excluded  from 
process  itself  (in  order  to  facilitate 
conversion),  but  are  included  in  the 
Control  process,  and  Test  process. 


of  management  and 
invocations  of 
the  PSMF  Function 
operating  system 
Library  routines, 


The  network  driver  provides  an  interface  between  PSMF 
processes  and  Arpanet.  By  convention,  network  reads  are 
requested  only  by  the  Network  Read  Steerer  and  Control 
process,  via  the  mediation  of  Library  routines.  Network 
writes  can  be  requested  by  any  orocess,  again  through  a 
Library  routine.  The  executive  manages  I/O  queuing. 


1 


Packet  Speech  Measurement  Facility 
PSMF  Design  Philosophy  and  Structure 


Page  "^0 
Section  2 


( 


2.3.2  Liorary  Routines 

These  are  a set  of  re-entrant  and  position  indeoendent 
routines  which  occupy  part  of  the  address  space  of  all 
PSMF  processes.  They  incorporate  functions  common  to  all 
processes,  and  when  structured  as  a Library,  serve  to 
reduce  total  core  space  requirements,  and  to  isolate 
explicit  references  to  executive  services.  RSX-11M 
requires  that  a Library  be  resident. 

2.3.3  Common  Area 

This  is  a buffer  or  data  area  which  occupies  oart  of  the 
address  space  of  all  PSMF  processes,  facilitating 
interprocess  communication.  RSX-11M  oermits  such  an  area 
to  be  dynamically  created. 


J 
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2.3.4  Network  Read  Steerer  and  Control  Process 


This  process  is  initiated  from  an  RSX-llM  terminal.  Its 
functions  are  to: 

a.  Initialize  PSMF  data  structures. 

b.  Initiate  a process  which  listens  to  the  NVP  initial 
connection  xink. 

c.  Make  judgements  as  to  the  disposition  of  all 
network  reads. 

d.  Communicate  to  processes,  via  global  semaphores, 
the  results  of  any  function  requiring  a network 
read.  This  process  will  often  be  referred  to  as 
the  "Control"  process. 
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2.3.5  Initial  Connection  Network  Listener  Process 


This  process  is  initiated  by  the  Control  process  (2.3.*^). 
Its  function  is  to  listen  to  NVP  link  377  for  a protocol 
sequence  indicating  a user's  request  for  a PSMF  function. 
If  this  sequence  is  received,  the  PSMF  Function  process  is 
initiated . 


2.3.6  PSMF  Function  Process 


This  process  is  initiated  by  the  Listener  process  (2.3.5) 
when  a user  requests  a PSMF  function,  and  terminates 
itself  on  receipt  of  an  NVP  "goodbye"  message.  It 
incorporates  all  the  NVP  and  PSMF  extensions  necessary  to 
communicate  with  the  user. 

The  principal  PSMF  functions  are  Recording,  Playback,  and 
Measurement.  Each  of  these  requires  access  to  PSMF  disk 
files.  Such  access  is  mediated  by  a group  of  routines 
which  specialize  RSX  file  manipulation  to  the  PSMF's 
needs. 


I 


ii 
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It  may  be  possible  that  the  PSMF  Function  process 
initiates  asynchronous  processes  on  its  own.  The 
Recording  function,  for  instance,  may  initiate  a process 
which  performs  a sort  on  user's  voice  time  stamps. 

2.3.7  Test  Process 

This  process  is  initiated  from  an  RSX-11M  terminal.  Its 
function  is  to  simulate  user  access  to  the  PSMF.  As  a 
PSMF  process  in  its  own  right,  it  conveniently  provides  a 
test  of  the  mujti-user  capabilities  of  the  design. 
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3.  Current  Implementation 


This  chapter  describes  in  detail  the  current  level  of  PSMF 
impi  ementation,  which  includes  a working  Record  and 
Playback  fa'^ixity. 

Section  3.1  discusses  the  data  structure  design  for  PS^F 
processes.  Section  3.?  describes  the  PSMF  file  structure. 
From  there,  a description  of  constituent  moduxes  ensues. 
Section  3.3  is  concerned  with  the  Network  Driver,  3.^  with 
the  Library  routines,  3.5  with  the  Control  process,  3.6 
with  the  Initial  Connection  Network  Listener  process,  3.7 
with  the  PSMF  file  accessing  routines,  3.8  with  the  Record 
junction  of  the  PSMF  Function  process,  3.9  with  the  Time 
Stamp  Sorting  Process,  3.10  with  the  Playback  junction  of 
the  PSMF  Function  process,  and  3.11  with  the  Test  orocess. 
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3.1  PSMF  Processes  Data  Structures 

It  was  envisioned  f rom  the  first  that  the  PSMF  would 
eventuaxly  support  multi-user  activity.  This  anticioation 
xed  to  the  design  of  a coherent  data  structure  for  all 
processes. From  the  standpoint  of  inter-orocess 
communication,  it  was  desirable  to  have  these  data 
structures  in  the  address  space  of  all  processes.  These 
considerations  xed  to  the  following  implementation: 

a.  All  processes  have  associated  entries  in  a "Link 
Table".  For  processes  which  are  actually  involved 
in  network  communications,  Link  Table  positions  map 
into  the  listening  NVP  links  for  that  process.  For 
processes  which  do  not  need  to  communicate,  pseudo 
link  positions  greater  than  400  are  allocated. 

b.  A process's  Link  Table  entry  points  to  its 

"Usertable",  which  contains  the  fundamental  data 
structure  for  the  process.(l)  The  Usertable  is 
allocated  f rom  the  Common  buff  er  area  when  the 


1.  With  the  exception  of  the  Test  process,  which  has 
unconventional  needs  for  RSX  associated  structures. 
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process  is  initiated,  and  de-allocated  when  the 
process  terminates. 

c.  Aii  other  data  structure  requirements  for  a process 
(e.g.  disk  buffers)  are  met  by  allocations  from  the 
Common  buffer  area.  Pointers  to  these  areas  can 
ultimately  be  found  in  the  Usertable. 

d.  Convention  dictates  that  a process  access  its 
Usertabj-e  using  indices  relative  to  a single 
dedicated  register.  This  convention  facilitates 
i itra-proc ess  communications. 


Figure  3-1  illustrates  these  data  structures. 
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Figur  e 3.1 

Figure  3.1  PSMF  Process  Data  Structure 
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In  addition  to  the  data  represented  in  each  Usertable, 
there  is  a need  for  global  data  which  can  act  as 
semaphores.  This  need  is  met  by  the  RSX  "event  flags" 

provision,  which  includes  executive  services  for  setting, 
clearing,  and  awaiting  such  flags. 

These  semaphores  are  used  to: 

a.  Lock  access  to  data  structures  to  prevent  possibly 

conflicting  alterations.  For  example,  the  linked 
list  of  buffers  in  Common  have  a semaphore 

associated  with  allocation  and  d ej-allocation . 

b.  Signal  processes  that  an  event  has  taken  olace. 

Each  of  the  PSMF  processes  has  a dedicated 

semaphore,  which  is  used  to  indicate  that  network 
I/O  has  been  completed,  or  that  a time  delay  is  up. 

c.  Signal  a request  for  services.  The  Control  orocess 
can,  for  instance,  be  awakened  by  its  dedicated 
semaphore  to  communicate  a request  for  a network 


r ead . 
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3.2  PSMF  File  Strucutre 

Data  pertinent  to  PSMF  storage,  retrieval,  and  measurement 
is  of  two  fundamentaly  distinct  types.  Firstly,  there  is 
the  actual  stream  transmitted  by  the  user.  Secondly, 
there  is  information  related  to  arrival  time  and 
sequence.  This  dichotomy  encouraged  the  following 
impl  anentation : 

a.  Any  recording  session  results  in  two  PSMF  files:  a 

"primary"  file  and  a "secondary"  file. 

b.  The  primary  file  consists  simply  of  the  stream  of 
data  transmitted  by  the  user.  Any  network 
responses  generated  by  the  PSMF  during  negotiation 
are  also  recorded  - to  serve  both  as  a debugging 
record  and  a guide  during  playback. 

c.  The  secondary  file  contains  the  recording  date  and 
time,  user  identification,  parcel  timing,  and  file 
size.  In  addition,  for  every  message  in  the 
primary  file,  the  secondary  file  contains  various 
flags,  PSMF  time  stamp,  and  sorted  link  to  next  (by 
user's  time  stamp)  message. 
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It  is  intended  that  the  secondary  file  contain  all 
information  needed  by  the  measurement  functions,  as 
well  as  that  necessary  for  ordered  playback. 

i 

3.3  Network  Driver 

The  network  driver  is  the  routine  in  the  RSX-11M  executive 
which  provides  full  duplex  access  to  the  Arpanet.  This 
access  is  achieved  via  standard  RSX  "QIO"  executive 
requests.  RSX  provides  the  mechanism  for  queueing 
requests  and  communicating  parameters  to  the  driver.  It 
is  the  driver’s  responsibility,  on  the  other  hand,  to 
signal  normal  or  abnormal  request  completion. 

The  PSMF  driver  was  designed  to  treat  the  interface  as  two 
separate  devices  - one  each  for  input  and  output. 
Completion  of  a type  3 network  write  (uncontrolled)  can  be 
signalled  merely  by  completion  of  physical  transfer  to  the 
IMP.  Completion  of  a type  0 network  write,  however, 
requires  reading  a corresponding  RFNM  from  the  destination 
IMP.  This  means  that,  in  general,  processes  do  not 
interface  directly  to  the  network  driver,  but  are  filtered 
through  Library  routines  which  cooperate  with  the  Control 
proc  ess. 


These  routines  consist  of  re-entrant  and  position 
independent  code  which  is  shared  by  ail  PSMF  processes. 
Whixe  such  an  entity  is  not  strictly  essential,  it  does 
serve  to  reduce  core  requirements  and  compartmentalize  the 
use  of  requests  for  executive  services. 

There  are  many  Library  routines.  They  are  briefly 
described  below. 

3.4.1  N etwo  rk  R ead 

This  routine  will  suspend  a process  if  a previous  network 
read  has  not  been  completed.  It  then  signals  the  Central 
process  that  data  is  expected  from  the  network. 
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3.4.2  Network  Write 

Type  3 writes  and  Type  0 writes  are  treated  ind eo end ently . 
The  Library  routines  will  wait  on  a write  of  a given  tyoe 
if  a previous  write  of  that  same  type  has  not  been 
completed.  A QIC  is  then  issued  to  start  the  write,  and, 
in  the  case  of  a write  type  0,  the  Control  process  is 
notified  that  a RFNM  is  expected. 

In  addition.  Library  routines  are  available  to  move  data 
to  a temporary  buffer  before  starting  the  write.  This 
avoids  locking  the  process’s  own  buffers  while  awaiting 
c ompl etion . 
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3.4.3  Wait  on  Network  I/O 


These  routines  are  called  by  a PSMF  process  or  by  other 
Library  routines  to  wait  until  completion  of  a network 
read,  write  type  0,  or  write  type  3.  If  no  I/O  is  in 
abeyance,  no  wait  is  effected. 

3.4.4  Usertable  & Process  Initiation 

If  a process  is  initiated  by  another  process,  some 
communication  of  data  is  usually  necessary.  A PSMF 
initiating  process  will  allocate  and  set  up  a Usertable 
for  the  initiated  process,  start  that  process,  and 
communicate  the  Usertable  address.  Library  routines 
perform  all  these  functions. 
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3.4.5  Time  Interval  Computation 

A process's  initiation  time  is  stored  in  its  Usertable.  A 
Library  routine  is  available  to  compute,  in  milliseconds, 
the  difference  between  the  time  of  call  and  the  time  of 
initiation.  This  is  used  as  the  PSMF  time  stamp  during 
the  PSMF  Record  function. 

3.4.6  Timed  Suspension  of  a Process 


This  routine  will  suspend  a process  for  a soecificied 
number  of  milliseconds.  It  is  used  by  the  PSMF  Playback 
function  to  time  the  transmission  of  encoded  voice 
packets. 


1. 
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3.4.7  Management  of  Common  Buffer  Pool 


The  common  pool  of  fixed  length  buffers  supplies 
Usertables,  network  I/O  buffers,  disk  buffers,  and 
temporary  work  space.  A pair  of  Library  routines  are  used 
to  allocate  and  free  such  buffers. 


3.4.8  Process  Exit 

This  routine  frees  all  the  buffers  owned  by  a process, 
resets  its  link  table  entry,  and  performs  an  RSX  exit 
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3.5  Control  Process 


The  Control  process  is  initiated  at  an  RSX-11M  terminal. 


Its  functions  are  threefold; 


it  initializes  PSMF 


resources,  acts  as  a network  read  steerer,  and  adjudicates 
network  I/O  completion. 


3.5.1  Initializaton  of  PSMF  Resources 


As  the  first  PSMF  process  to  be  invoked,  it  is  the  Control 
process's  job  to  initialize  resources: 


a.  Interprocess  semaphores  are  reset. 


b.  The  Link  table  is  cleared 


c.  A Common  buffer  region  is  dynamically  created  and  a 
mechanism  is  set  up  to  allow  all  future  processes 
to  map  to  it. 


I 
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; d.  The  IMP  is  primed  with  a f ew  NOPS. 

e.  The  Initial  Connection  Listening  Process  is 
initiated . 

f.  A network  read  is  started. 

3.5.2  Network  Read  Steerer 
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The  initial  network  read  will  wake  up  the  Control  process 
when  two  words  (32  bits)  have  been  transferred  into  a 
special  header  buffer.  The  Control  process  analyzes  this 
header  to  effect  the  disposition  of  the  rest  of  the 
messag  e : 

a.  Unrecognizable  headers  cause  the  remaining  message 
to  be  discarded. 

b.  Links  on  type  0 and  3 messages  _re  examined. 

i)  If  it  is  not  an  NVP  link,  the  message  is 
discarded . 

ii)  If  the  link  is  not  owned  by  a PSMF 
process,  the  message  is  discarded. 
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iii)  If  the  owning  PSMF  process  had  requested 
a network  read,  the  remaining  message  is  read 
into  the  area  designated  by  the  process. 

iv)  Otherwise  a free  buffer  is  allocated,  the 
remaining  message  is  read  into  it,  and  the 
process  is  flagged  as  having  received  an 
unsolicited  read.  This  facility  is  designed 
to  allow  the  Recording  function  to  fall  a 
little  behind  in  its  retrieval  of  type  3 
messages. 


c . A NOP  is  ignored . 

d.  A RFNM  is  used  to  flag  the  corresponding  network 
write  type  0 as  complete, 

e.  An  "incomplete  transmission"  is  ignored.  Failure 
of  a type  0 write  is  noted  when  no  RFNM  arrives 
within  five  seconds. 

f.  An  "interface  reset"  forces  transmission  of  a f ew 
NOP's  and  discarding  the  first  input. 
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g.  All  other  messages  are  ignored. 


3.5.3  Adjudication  of  Network  I/O  Completion 


The  Control  process  is  notified  of  all  requests  for 
network  reads. 

a.  If  an  unsolicited  read  has  already  been  undertaken 
on  behalf  of  the  requesting  process,  its  data  are 
moved  to  the  requested  area  and  the  unsolicited 
buff  er  flu  shed . 

b.  Otherwise  the  next  network  read  with  an  appropriate 
link  is  steered  into  the  requested  area. 

In  addition,  the  Control  process  is  notified  of  all 
completed  network  I/O.  This  provides  a central  point  for 
resolution  of  PSMF  process  waits  on  network  I/O.  For 
example,  if  a process  requests  a wait  until  completion  of 
network  write  type  0; 

a.  The  request  is  made  through  a Library  routine  which 
checks  if  such  a write  has  been  requested  but  not 
finished.  If  not,  an  immediate  return  is  effected. 
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b.  The  Library  routine  then  clears  a global  semaphore 
assigned  to  the  PSMF  process,  sets  a "wait"  flag  in 
its  Usertable,  and  issues  an  RSX  executive 
directive.  RSX  will  resume  the  process  when  the 
global  semaphore  has  been  set. 

c.  When  the  Network  Read  Steerer  section  of  the 
Control  process  detects  the  appropriate  RFNM,  it 
sees  the  PSMF  process's  wait  flag,  and  sets  the 
proper  global  semaphore.  RSX  is  thus  signalled  to 
awaken  the  PSMF  process. 

3.6  Initial  Connection  Network  Listener 

NVP  initial  connection  protocol  requires  an  opening 
request  on  link  377.  Since  PSMF  orocesses  are  in  general 
associated  with  links,  it  was  convenient  to  assign  the 
initial  connection  function  to  a distinct  process.  This 
Listener  process  is  initiated  by  the  Control  process  on 
PSMF  initialization  (3.5.1)  and  performs  the  following 


duties: 
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It  requests  a network  read  on  its  link  of 


377  and 


waits  pending  read  completion. 


b.  When  a message  with  the  correct  format  is  received, 
the  Link  table  is  searched  for  the  first  free 
entries.  Such  entries  are  mapped  to  a link  number, 
e.g.  link  360. 


c.  The  PSMF  process  associated  with  that  link  number 
is  initiated  e.g.  the  process  named  "NVP360." 


d.  The  Listener  process  allocates  and  sets  ud  a 
Usertable  for  the  new  process,  sends  the  Usertable 
address,  and  goes  back  to  the  listening  start.  It 
is  the  new  PSMF  process's  r esoonsib ility  to  carry 
on  all  communications  on  its  own  links. 
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3.7  PSMF  File  Accessing  Routines 

These  are  a series  of  modules  designed  to  interface 
between  a PSMF  process  and  RSX-11M  file-handling 
primitives.  While  suitable  for  Library  inclusion,  soace 
limitations  now  dictate  that  these  routines  be  linked 
separately  with  each  file  handling  PSMF  nrocess. 

Each  routine  deals  with  a single  file  at  a time,  e.g.  with 
either  a primary  or  secondary  file.  Access  is  by  record 
at  the  PSMF  level  and  by  block  at  the  RSX  level.  Several 
processes  can  simultaneously  access  a single  file. 

An  outline  of  the  routines  follows. 
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3.7.1  File  Open  Routines 

A PSMF  file  may  be  opened  for  writing  (record),  reading 
(playback,  etc.),  or  updating  (aopend).  In  each  case,  the 
using  process  supplies  the  record  size,  file  name,  and  the 
file  number  (0  thru  3)  which  will  be  used  for  all  future 
accesses. 

A file  open  routine  will  also  allocate  Common  buffer  space 
for  RSX  specific  file  information,  and  two  block  buffers 
for  each  file. 


3.7.2  File  Close  Routine 


The  file  close  routine  will  initiate  an  RSX  file  close  and 
free  buffer  space  used  by  the  file. 
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3.7.3  Disk  Read  Routines 

The  disk  read  routines  require  a file  number  and  record 
number  for  access.  A pointer  to  the  requested  record  is 
returned.  As  an  option,  the  sequential  read  routine  tries 
to  insure  that  a record's  predecessor  and  successor  are  in 
core  in  anticipation  of  future  reference. 

3.7.4  Disk  Write  Routines 

The  PSMF  disk  write  routines  write  only  out  of  the 
"current"  record  buffer;  in  order  to  change  a record, 
that  record  must  first  be  read.  As  an  option,  the 
sequential  write  routine  increments  the  "current"  record 
number  and  buffer  address  after  each  write. 

Both  the  read  and  write  routines  employ  two  block  buffers 
(16  primary  file  records  or  64  secondary  file  records). 
No  physical  disk  transf  er  take  place  if  either  of  the  two 
block  buffers  contains  the  desired  record. 
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3.8  Record  Function 


The  PSMF 

Function 

proc  ess 

(R  ecord 

and  Playback) 

is 

initiated 

by  the 

Network 

Listener 

proc  ess  (3.6). 

The 

Function  process  continues  the  opening  orotocol  and  awaits 
a PSMF  command. 

The  PSMF  Record  command  has  provision  for  a filename  and 
oDtional  password.  The  Record  function  is  called  and: 

a.  Opens  two  PSMF  files:  one  with  64-word  records  and 

the  extension  ".PR"  (primary  file)  and  the  other 
with  8-word  records  and  the  extension  ".SE" 
(secondary  file). 

b.  Sends  an  acknowledgement  to  the  user. 

c.  Records  the  PSMF  Record  command  as  the  primary 
file's  first  record. 

d.  Records  the  date,  time,  and  user  ID  as  the  first 
record  of  the  secondary  file.  Parcel  timing  and 
file  size  information  is  added  to  this  record  at 
the  conclusion  of  the  recording  session. 
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The  Record  function  then  goes  into  a network  listen  loop 
in  which  certain  messages  are  recorded  on  the  disk.  These 
messages  which  are  stored  are; 

a.  PSMF  "field  to  be  recorded"  messages. 

b.  All  acceptable  negotiations  for  voice  transfer. 
The  Record  f uncton  will  accept  all  suggestions 
(except  for  message  size  greater  than  976  bits.) 

c.  All  voice  negotiation  replies  from  the  PSMF  to  the 
user.  These  are  flagged  appropriately  and  are  used 
as  a guide  during  Playback. 

d.  When  sufficient  information  for  Playback  timing  is 
available,  the  user  can  terminate  negotiation  and 
record  voice  messages. 

Every  stored  message  has  an  entry  in  each  of  the  primary 
and  secondary  files. 

a.  The  entire  message  is  stored  as  a single  record  in 
the  primary  file  as  it  is  received,  preceded  by  a 
word  containing  its  length. 


Li 
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The  corresponding  record  in 

the 

s econdary 

file 

contains  a f iexd  name  word. 

a flag 

wo  rd  , 

the 

PSMF 

time  stamp  in  milliseconds,  words  3 

and  4 

of 

the 

message,  and  provision  for 

a link  to 

the 

n ext 

record  (to  be  sorted  by  user's 

time 

stamo 

by 

the 

"Sort  by  Time  Stamo"  process). 

The  Record  function  remains  active  until  receiot  of  an  NVP 
"goodbye"  or  PSMF  "end  of  file"  message.  In  either  case, 
the  primary  and  secondary  files  are  completed  and  closed. 
The  Sort  process  is  initiated  in  order  to  link  the 
secondary  file  by  user's  time  stamp.  A "goodbye"  will 

terminate  the  NVP  connection,  while  an  "end  of  file"  will 
cause  control  to  return  to  the  start  of  the  PSMF  Function 
process. 
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3.9  Sort  Process 


The  Arpanet  does  not  guarantee  the  integrity  of  a stream 
of  type  3 messages.  Voice  packets  may  arrive  at  the  PSMF 
out  of  sequence,  as  duoiicates,  or  may  not  arrive  at  all. 

It  is  the  function  of  the  Sort  orocess  to  link  a PSMF 
message  file  so  that  Playback  message  sequence  will 
closely  approximate  that  in  which  they  were  sent.  This  is 
accomplished  by 

a.  Linking  the  voice  messages  by  the  sender's  time 
stamp . 

b.  Linking  imbedded  PSMF  "field  to  be  recorded" 
messages  as  propitiously  as  oossibxe. 

The  Sort  process  is  initiated  by  the  record  function  at 
the  concxusion  of  a recording  session.  The  Sort  orocess 
has  no  requirements  for  network  communication,  so  is  given 
a link  table  entry  corresponding  to  a network  link  greater 
than  400  (see  section  3.1).  It  opens  the  secondary  file 
with  shared  access  (to  allow  concurrent  oxayback)  and 
performs  the  following  functions: 
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a.  Using  the  parcex  timing  information  from  the  first 
record,  a one  minute  "window"  is  estimated.  This 
is  the  maximum  number  of  oackets,  at  seven  parcels 
per  packet,  which  could  be  sent  in  one  minute.  No 
search  for  a given  record's  link  will  exceed  the 
boundaries  imposed  by  plus  or  minus  one  window. 

This  is  a consequence  of  the  one-word  length  of  the 
user's  time  stamp.  An  unrestricted  search  for  a 
given  time  stamp  could  result  in  linkage  to  an 
inappropriate  message  with  the  same  time  stamp 
modulo  2**16  as  that  expected. 


b.  An  expected  time  stamp  is  computed  from  the  present 
time  stamp  and  parcel  count. 


c . 


A forward  search 
to  the  window 
(imbedded  or 
immediately , it 
begins  again, 
encountered,  it 


of  the  secondary  file  is  made  up 
boundary.  If  a control  message 
preliminary)  is  encountered 
is  linked  and  the  entire  search 
If  the  expected  time  stamp  is 
is  linked  and  a new  search  begins. 
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d.  Otherwise  a search  in  the  negative  direction  uo  to 
a window  boundary  is  made.  If  the  expected  time 
stamp  is  encountered,  it  is  linked  and  a new  search 
b egins. 

e.  Otherwise  a link  is  made  to  the  record  with  the 
time  stamp  differing  least  from  the  expected  time 
stamp,  if  any. 

f.  Otherwise  the  sort  terminates.  (No  more  records). 

This  algorithm  permits  linkage  of  files  consisting 
entirely  of  control  messages  as  well  as  those  with 
duplicate  or  missing  messages. 


3.10  Playback  Function 


Once  a PSMF  file  has  been  created  by  the  Record  function 
and  linked  by  the  Sort  process,  it  can  be  accessed  by  the 
Playback  function  of  the  PSMF  Function  process. 

The  PSMF  Playback  command  has  provisions  for  filename  and 
password.  When  this  command  is  encountered  by  the  PSMF 
Function  process, 
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a.  An  attempt  is  made  to  open  the  primary  and 
secondary  fij.es  associated  with  the  filename.  If 
this  attempt  is  unsuccessful,  a negative 
acknowledgement  is  sent  to  the  user. 


b.  The  first  record  of  the  primary  file  is  read  to 
determine  the  password.  If  no  password  was  used 
for  recording,  no  check  is  made  of  that  included 
with  the  playback  command. 

c.  A password  comparison  is  made.  If  a bad  match  is 
found,  a negative  acknowledgement  is  sent  to  the 
user . 


d.  Ej.se  a positive  acknowledgement  is  sent  and  the 
Pj.ayback  function  awaits  user  commands  specifying 
the  information  to  be  retrieved. 

The  PSMF  extension  to  the  NVP  protocol  permits  selective 
retrieval  of  stored  information.  In  particular,  the  user 
can  request  the  playback  of  any  combination  of: 

a.  Non-PSMF  control  messages. 
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b.  PSMF  control  messages  or  subsets  thereof. 

c.  Voice  messages. 

The  user  specifies  a list  of  his  selections  in  a PSMF 
"fields  to  be  retrieved"  command.  The  Playback  function 
then  performs  the  following: 

a.  If  the  user  has  specified  voice,  the  PSMF  conducts 
negotiations  as  per  those  which  were  recorded.  If 
the  user  disagrees  with  any  of  the  recorded 
negotiations  the  playback  session  is  terminated. 

b.  The  secondary  file  is  scanned  from  the  beginning  to 
find  any  message  types  on  the  user's  list.  If 
found,  the  corresponding  record  in  the  primary  file 
is  transmitted. 


c.  The  interval  timing  between  voice  message 

transmission  is  computed  from  the  parcel  count  and 
parcel  timing  data. 

d.  If  no  further  messages  are  to  be  retrieved,  or  if 
the  user  sends  a PSMF  "end  of  file"  command, 
Playback  sends  a count  of  messages  transmitted  and 
awaits  a further  list  of  selections  from  the  same 
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file.  An  NVP  "goodbye"  elicits  the  same  count  and 
a termination  of  the  Playback  session. 


3.11  T est  Pr oc  ess 


The  Test  process  was  designed  to  provide  a full  testing 
facility  for  the  PSMF  implementation.  It  essentially 
consists  of  highly  RSX  dependent  code,  initiated  from  an 
RSX  terminal,  which  can  read  or  write  RSX  files  and  access 
the  Arpanet  as  a PSMF  process. 

When  initiated,  the  Test  process: 

a.  Takes  NVP  links  375  and  376  for  its  own  read  links. 

b.  Asks  for  an  input  RSX  file  to  read  data  and  an 
output  file  for  results. 

The  input  data  can  be  commands  to: 

a.  Affect  network  output:  i.e.  change  destination 

HOST/IMP,  output  link  or  message  type. 
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b.  Read  network  input. 

In  addition,  data  to  be  transmitted  over  the  network  can 
consist  of  strings 

N(1  ),  N(2),  . . . ,N(K) 

where  each  N(I)  is  the  octal  representation  of  a PDP-11 
word  or  byte,  or  an  ASCII  string  enclosed  in  double 
quotes. 

These  data  strings  are  converted  to  an  Arpanet  message  and 
transmitted,  typically  through  the  IMP  and  back  to  a PSMF 
process.  Data  received  from  a network  read  are  converted 
to  similar  readable  strings  and  sent  to  the  Test  process 
output  file.  This  permits  interactive  (via  a terminal)  or 
high  speed  (via  an  RSX  disk  file)  testing  of  PSMF 


c onstituents. 
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4.  Implementation  Completion 


The  schedule  included  in  the  Preliminary  Design  document 
gives  August  15,  1977  as  a first  release  date  and 

September  30,  1977  as  a final  release  date  for  this 
implementation  of  the  PSMF. 

The  first  release  will  incorporate  the  following 
improvements  and  augmentations  over  the  trial  release: 

a.  The  Append  and  Delete  functions  will  be  included  in 
the  PSMF  function  process. 

b.  Improvements  will  be  made  in  the  error  recovery 
procedur  es. 

c.  Further  discrimination  will  be  oossible  to  enable 
Playback  of  various  subtyoes  of  PSMF  control 
messages. 

The  final  release  will  incorporate  the  Measuranent 

function  of  the  PSMF  Function  process.  This  will  enable 
quantitative  analyses  of  PSMF  files.  These  analyses  will 
produce  PSMF  files  consisting  of  measures  of: 


r ^ “ 
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a.  Relative  delays  experienced  by  voice  oackets. 

b.  Durations  of  speech  and  silent  periods. 

c.  Classifications  of  packet  sequences  into 

I duplicates,  missing,  or  out  of  order. 

d.  Classifications  of  packet  types. 

i 

e.  Histograms  or  statistical  properties  of  the  above. 

These  measurement  files  will  be  accessabie  via  the 
Playback  function. 
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5.  Summary 


This  report  has  described  the  work  oerformed  at  CCA  on  the 
Packet  Speech  Measurement  Facility  during  the  initial 
phase  of  its  development. 


A r evi  ew 

of 

PSMF 

design  objectives  was  followed 

by  a 

discussion 

of 

the 

structure  formulated  to  meet 

these 

objectives, 

An 

aopropriate  protocol  extension 

wa  s 

described,  which  was  followed  by  a detailed  descriotion  of 
the  current  impl  anentation  and  its  components.  A short 
summary  of  work  scheduled  to  complete  this  phase  ensued. 

The  trial  release  of  the  PSMF  Record  and  Playback 
functions  has  been  successfully  employed  by  members  of  the 
NSC  community.  We  anticipate  regular  experiments  once  the 
protocol  extensions  are  incorporated  into  user  NVP's. 
Plans  are  currently  under  consideration  for  expansion  of 
PSMF  capabilities  to  give  participants  greater  control 
over  and  better  access  to  those  experimental  situations  of 
interest  to  them.  It  is  in  this  context  that  the  PSMF 
will  become  a valuable  network  facility. 


